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MACSbug 
INSTALLATION AND OPERATING INSTRUCTIONS 



1 . 1 INTRODUCTION 

This document describes the Corvus Concept MACSbug Debugger Version 
2.0. It includes a description of the commands for the resident 
firmware monitor, MACSbug, and examples of its use. 

1.2 INSTALLATION PROCEDURES 

NOTE: Before powering the base unit ON or OFF, ensure that there is no 
diskette in the floppy drive. 

a) Power-off the Concept base and display. 

b) Disconnect the keyboard cable and display monitor cable. Open the 
drawer of the base unit and remove the power supply cables connected 
at locations labeled J8 and Jl on the processor board and the memory 
board respectively. Remove any tap cables or interface cards which 
are currently in the drawer. 

c) Lift up on the drawer assembly and completely remove it from 
the base unit. 

d) The procedure to install MACSbug ROMs is different for REV 03 
processor boards and REV 04 processor boards. You can determine 
whether you have a REV 03 or REV 04 by the configuration of the 
Concept boot switches. 

On the REV 03 processor boards, there is a 2-switch microswitch on 
the right side of the processor board, opposite the I/O slots. 

On the REV 04 processor boards, there is a 8-switch microswitch on 
the right side of the processor board, opposite the I/O slots. 



e) Revion 03 Installation Procedures 

1. Locate the Boot ROMS on the processor board at locations U706 (ROM 
0U) and D711 (ROM 0L) . If they are not version 0.5 or later, 
remove the ROMs at these locations and place the ROM labeled CC 
0.5 H or later in location U706 and place the ROM labeled CC 0.5 L 
or later in location D711 on the processor board. 
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Place the ROM labeled MACSbug 2.0 L in location U709 and place 
the ROM labeled MACSbug 2.0 H in location O708 on the processor 
board. The MACSbug ROM sockets are 28 pin sockets, and the 
MACSbug ROMs are 24 pin devices. The sockets should have the 
top four pin locations unused ( i.e. pins 1,2,27 and 28). 



3. Place both microswitches in the ON position. 




f) Revison 04 Installation Procedures 

1. Locate the Boot ROMS on the processor board at locations U706 (ROM 
0L) and U710 (ROM 0U) . If they are not version 0.5 or later, 
remove the ROMs at these locations and place the ROM labeled CC 
0.5 H or later in location O710 and place the ROM labeled CC 0.5 L 
or later in location U706 on the processor board. 
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Place the ROM labeled MACSbug 2.0 L in location U708 and place 
the ROM labeled MACSbug 2.0 H in location U709 on the processor 
board. The MACSbug ROM sockets are 28 pin sockets, and the 
MACSbug ROMs are 24 pin devices. The sockets should have the 
top four pin locations unused ( i.e. pins 1,2,27 and 28). 

Place microswitches 7 and 8 in the ON position. 




g) Replace the drawer into the base unit and position the two 
power supply cables along the speaker tray channel to prevent 
chaffing of the cables. Reconnect the power supply cables to 
J8 on the processor board and Jl on the memory board. 

h) Reconnect any tap cables or interface cards originally within the 
drawer. 

i) Power on the display and then the base unit. The Concept will 
emit a beep, and then request input from the user regarding 
the boot device as follows: 

Select the device : (D,F,L,0) : 

D - Debug (MACSbug) 
F - Floppy Disk Drive 
L - Local Disk Drive 
- Omninet Drive 

j) Select your normal disk boot option to run a quick check of the 
unit. 

k) If the unit does not complete the boot, check the ROM locations and 
that all pins of the ROMs are installed correctly. Repeat the 
procedure until the system boots. If problems persist, contact 
your local servicing dealer or Corvus Customer Service. 



1.3 COMMMUNICATING WITH MACSbug 

Communication with MACSbug is performed through the two serial' ports on 
the back of the Corvus Concept- When used with MACSbug, port 1 has a 
default data rate of 9600 BAUD, parity is disabled and an 8 bit 
character size is assumed. An ASCII terminal must be attached to port 
1 with a null modem cable. This terminal is the MACSbug console. 

MACSbug supports port 2 as a standard RS-232C data terminal connector 
with a default data rate of 4800 BAUD, parity disabled and a 8 bit data 
character size. Port 2 can be used to communicate with a host computer, 
a printer or other serial device. 

This two port communication arrangement allows the Corvus Concept to be 
placed in series with an ASCII terminal and a host computer. The 
transparant mode in MACSbug can be used to bypass the Corvus Concept. 
This allows a program to be created on the host computer using the ASCII 
terminal and then when the program code file is generated, it can be 
downloaded into the Corvus Concept for execution and dubugging. This 
can all be performed without reconfiguring the cabling. 

1.4 OPERATIONAL PROCEDURE 

After the MACSbug ROMs has been installed, MACSbug can be entered 
before the Corvus Concept operating system is booted as follows: 

a. Connect an ASCII terminal to port 1 of the Corvus Concept. 

b. Ensure that the Concept boot switches are both in the ON position. 

c. Power on the Corvus Concept. 

d. Select option D, for Debugger, when prompted. 

MACSbug will initialize and display on the ASCII terminal connected to 
port 1 with the following message: 

MACSBDG 2.0 

* 

If these two lines do not print out, perform the following: 

a. Check to see that the ASCII terminal is attached to RS-232C 
port 1 using a null modem cable. 

b. Ensure that the terminal's BADD rate is set to 9600, parity is 
disabled and an 8 bit character size is selected. 



1.5 COMMAND LINE FORMAT 

Commands are entered the same as in most other buffer organized computer 
systems. A standard input routine controls the system while the user types 
a line of input. The delete (ROBOUT) key or control H will delete the 
last character entered. A control X will cancel the entire line. 
Control D will redisplay the line. Processing begins only after the 
carriage return has been entered. 



The format of the command line is: 
*COmmand parameters ;options 



where: 



is the prompt from the monitor. The user does 
not enter this. In the examples given, the lines 
beginning with this character are lines where the 
user entered a command. 



CO 



parameters 



;options 



is the necessary input for the command. Each 
command has one or two upper case letters 
necessary in its syntax. In the examples, the 
entire command may be used, but only those 
letters in upper case in the syntax definition 
are necessary. In actual usage, MACSbug converts 
all lower case characters to upper case. 

is the unnecessary part of the command. It is 
given in the syntax definiton only to improve 
readability. If this part of the command was 
actually entered on the command line, it would be 
ignored. 

depends upon the particular command. Data is 
usually in hex but most printable ASCII 
characters may be entered if enclosed in single 
quotes. The system also supports a limited 
symbolic feature allowing symbols to be used 
interchangeably with data values. 

modifies the nature of the command. A typical 
option might be to disregard the checksum while 
downloading. 



1.6 MACSbug COMMAND SUMMARY 
COMMAND 



DESCRIPTION 



reg* 

reg# hexdata 

reg* 'ASCII' 

reg#: 

class 

class: 

DM start end 

SM address data 

OPen address 

SYrabol NAME value 

W* 

W#.len EA 

M* data 

Go 

Go address 

Go TILL add 

BReakpoint 

BR add: count 

BR -address 

BR CLEAR 

TD 

TD reg*. format 

TD Clear 

TD ALI 

TD A.l D.l L.c 

T 

T count 

T TILL Address 

:*(CR) 

OFfset address 

CV decimal 

CV $hex 

CV value, value 

REad;=test 

VErify;=text 

CA11 address 

P2 

♦..data 

CTL-A 
CTL-D 
CTL-H 
CTL-X 



Print a register 1.6.1 

Put a hex value in the register 

Put hex-equivalent characters in register 

Print the old value and request new value 

Print all registers of a class (A or D) 

Sequence through-print old value request new 

Display memory, hex-ASCII memory dump 1.6.2 

Set memory with data 

Open memory for read/change 1.6.3 

Define and print symbols 1.6.4 

Print the effective address of the window 1.6.S 

Define window length and addressing mode 

Memory in window, same syntax as register 

Start running from address in program counter 1.6.6 

Start running from this address 

Set temporary breakpoint and start running 

Print all breakpoint addresses 

Set a new breakpoint and optional count 

Clear a breakpoint 

Clear all breakpoints 

Print the trace display 1.6.7 

Put a register in the display 

Take all registers out of the display 

Set all registers out of the display 

Set register blocks or line separator 1.6.8 

Trace one instruction 1.6.9 

Trace the specified number of instructions 

Trace until this address 

Carriage return-trace one instruction 

Define the global offset 1.6.10 

Convert decimal number to hex 1.6.11 

Convert hex to decimal 

calculate offset or displacement 

Expect to receive S records 1.6.12 

Check memory against S records 

JSR to user utility routine 1.6.13 

Enter transparent mode 1.6.14 

Transmit command to host 

The control A key ends transparent mode (default) 
The control D key redisplays the line 
The control H key deletes the last character entered 
The control X key cancels the entire line 



1.6.1 Set and Display Registers 

68000 REGISTER MNEMONICS DESCRIPTION 



REGISTER DISPLAY 



D0,D1,D2,D3,D4,D5,D6,D7 

A0,A1,A2,A3,A4.A5,A6,A7 

PC 

SR 

SS 



US 



COMMAND FORMATS 



reg# hexdata 

reg# 'ascii data' 

reg#: 

reg# 

class (where class=D or A) 

class: 



EXAMPLES 

*A5 123 

*A5 

A5=00000123 

*D4 FFPFPP 

*D0: 

D0=0000000 ? 45FE 

*D: 

D0=000045FE ? 9EAB3 

D1=00000000 ? (CR) 

D2=00000000 ? (CR) 

D3=00000000 ? (CR) 

D4=00FFFFFF ? (CR) 

D5=00000000 ? 55555 

D6=00000000 ? (CR) 

D7=00000000 ? (CR) 

*D 

DO=0009EAB3 D1=00000000 

D4=00FFFFFF D5=00055555 

*PC: 



Data registers 

Address registers 

Program counter 

Status register (condition codes) 

Supervisor stack pointer (A7 in supervisor 

mode) 

User stack pointer (A7 in user mode) 

DESCRIPTION 

Put a hex value into register ' reg#' 

Put hex value of ASCII into register ' reg#' 

Print register value and request in new value 

Print register value 

Print values of all registers in the class 

Cycle through all registers in the class 

printing old value and requesting new value 



PC=>0008B3 ? 
*SR 
*A7 4321 
*OS 

US=00004321 
*SS FFC 
*SR 2000 
*A7 
A7=O0OO0FFC 



2561 



COMMENTS 

Set address register A5 to hex value 123 
Command to print the value of register A5 
Computer response 
Set a data register 

Command to print old value and take in new value • 
Computer prompts with old value; new value entered 
Command to cycle through all data registers 
Change value of register DO from 45FE to 9EAB3 

Carriage return (null line) means the value 
remains the same 



Change register D5 to a new value 



Display all -data registers 

D2=*00000000 D3=00000000 

D6=00000000 D7=00000000 

Display and request input for program counter 
Set the program counter to new value 
Set status register to zero (user mode) 
Set address register (same as US now) 
Display user stack pointer 

Set supervisor stack pointer 

Set status register to supervisor mode 

Print A7 which is now the SS register 

Initialize system stack pointer value from 

MACSbug 



1.6.2 Display and Set Memory MEMORY DISPLAY 

COMMAND FORMAT DESCRIPTION 

DM start end Display Memory in hex and ASCII where start 

< end 
DM start count Where start > count 

DM2 start end Send output to PORT 2 

SM address data Set Memory to hex 

SM address 'ASCII' Set Memory to ASCII 

SM address data N The 'N' as the last character means start a 

new line? the system will prompt with the 

current address 

EXAMPLES COMMENTS 

*SM 92000 'ABC Set memory to some ASCII data 

*SM 92003 4445 46 'G' Set some more locations 

*DM 92000 92010 Command to dump memory 

0092000 41 42 43 44 45 46 47 00 00 00 00 00 00 00 00 00 ABCDEFG 

0092010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

In the following usage of the DM 

command the second number is smaller than 

the first so it is decoded as a count. 

*DM 92003 12 

0092003 44 45 46 47 00 00 00 00 00 00 00 00 00 00 00 00 DEFG 

0092013 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

*SM 9100n 1 97 4^6 7890 ABCDE 12345678 Size can be up to 8 characters 

*DM 91000 

091000 01 23 04 56 78 90 0A BC DE 12 34 56 78 00 00 00 

*SM 91000 'TABLE ' 00005678 N Use of the 'N' parameter to 

start a new line 

0009100C? 'START ' 00023456 

*DM 91000 20 

091000 54 41 42 4C 45 20 20 20 00 00 56 78 53 54 41 52 TABLE. .. .VxSTAR 

091010 54 20 20 20 00 02 34 56 00 00 00 00 00 00 00 00 T 4V 

♦OFFSET 2030 Global offset will be added to 

*DM 91000 command parameters 

093030 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FP FF 

*SM 91005 1234 N Global offset added to address 91005 

00093037 ? AB 

*DM 91000 

093030 FF FF FF FF FF 12 34 AB FF FF FF FF FF FF FF FF 



*SM 20000 AB CD EF Trying to set ROM 

ERROR Error message 



1.6.3 Open Memory for 
COMMAND FORMAT 
OPen address 
SUBCOMMAND FORMAT 
(CR) 



Read/Change 
DESCRIPTION 



OPEN MEMORY 



Open memory at specified address and enter subcommand 
mode 



Go to next sequential location 

Go to previous location 

Stay at same location 

Return to MACSbug(exit the OPen command) 



ADDRESS 




CONTE1 


*OP E00 






00OEOO 




= FF? 


0OOEO1 




= AB? 


000EO2 




= 44? 


000E01 




= AB? 


000E00 




= 12? 


000E00 




= 77? 


000EO0 

* 




= 77? 


*OP 21234 






021234 




= FF? 


**NO CHANGE** 




021234 




= FF? 


*0P E00 






OO0EOO 00? 


W 




W IS NOT A 


HEX 


DIGIT 



USER 
ENTERS 



12 
(CR) 
34" 
77 = 



COMMENTS 

Open memory location E00 

User enters data and system goes to next 

location 

Carriage return means go to the next 

location 

OP arrow means go to previous location 

Can be entered without data 

Equal sign means stay at same address 

Can be used without any data 

Period means return to MACSbug 

Returns to command level 

Example of trying to change ROM 

Warning message 

Does not abort command 

Enter invalid character 
Print error message 
Command is aborted 



1.6.4 Define and Print Symbols 
COMMAND FORMAT DESCRIPTION 



SYMBOLS 



Put a symbol in the symbol table with a hex value 
or assign a new value to a previously defined 
one. NAME can be 8 characters long, consisting 
of :A-Z, 0-9, (period) , and $(dollar sign). It must 
begin with letter (A-Z) or period, 
-name Remove a symbol from the symbol table 

name Print the current value of the symbol (absolute) 

value Print the first symbol with the given value 

Print the sorted symbol table 

NOTE 

Offset is not used by this command. Some commands 
recognize the words TILL, ALL. and CLEAR as key words 
and will not interpret them as symbols. 



SYmbol name hex value 



SY 
SY 
SY 
SY 



EXAMPLES 

*SY XYZ 5000 

*SY-XYZ 

XYZ=5000 

*SY XYZ 123 

*SY ABC34 2500 

*SY Z17.RT5 XYZ 

*SY-123 

XYZ=123 

*SY BS67ABC 4300 

*SY RFLAG 200 

*SY MVP2 9990 

*SY 

ABC34 00002500 

RFLAG 00000200 



COMMENTS 

Puts the symbol in the table 

Command prints out the symbol's current value 

Change a symbol's value 

Define another symbol 

Define a symbol with value from another symbol 

Print first symbol with value of 123 

Define some more symbols 



Print the sorted symbol table 
B$67ABC 00004300 MVP2 00009990 

XYZ 00000123 Z17.RT5 00000123 



*SY TTT 

T IS NOT A HEX DIGIT 

*SY 567 

00000567=567 

SYNTAX EXAMPLES 

*BR MVP2 
*CALL RFLAG 
*PC ABC34 
*DM MVP2 10 



Print a value for symbol not in table, when not 

found, it tries to convert parameter to number 
Attempt to print value for symbol not in table 



COMMENTS 



Set a symbolic breakpoint 
User define routine 
Set a register 
Display some memory 



EXAMPLES OP KEY WORDS IN COMMANDS 



*BR CLEAR 

*GO TILL Z17.RT5 

*T TILL ABC34 



The word CLEAR is not considered h symbol here 
The word TILL is part of the comni nd 
The word TILL is part of the command 



1.6.5 Displaying and Accessing Memory through Windows 



WINDOWS 



A "window" is an effective address through which the user can "see" memory, 
the windows are labeled WO to W7 and are defined using the syntax listed 
below. The windows address corresponding memory locations labeled MO to M7 
which use the same syntax as registers. These memory locations can be 
examined, set or defined in the display the same as a register. 



COMMAND FORMAT 



DESCRIPTION 



W# 
Wt.len EA 



Print the effective address of a given window 
Define a window size and effective address 
# is the window number to 7 
len is the length in bytes 
l=byte; 2=word; 3=3 bytes; 4=long word 
0=close a window (undefine it) 
EA is Effective Addressing mode 
(see EA SYNTAX EXAMPLES in table below) 
Pseudo registers have same syntax as registers 



M# data or 'ASCII 1 



EA SYNTAX EXAMPLES 

FE8 

(A6) 

-100(A6) 

-10(A6,D2) 

-100(*) 

10(*,D4) 

EXAMPLES 



DESCRIPTION 

Absolute address in hex 

Address register indirect in hex 

Indirect with displacement in hex 

Indirect with index and displacement in hex 

Program counter with displacement in hex 

Program counter with index and displacement in hex 

COMMENTS 



*W3.4 (A6) 

*A6 92000 

*W3 

W3.4 (A6)=92000 

*M3 873 42 

*M3 

M3=00087342 

*DM 92000 

092000 00 08 73 42 00 

*TD CLEAR 

*TD PC. 2 A6.3 M3.1 

*TD 

PC=00A2 A6=092000 M3 

*W3.2 (A6) 

*TD M3.2 

*TD 

PC=00A2 A6=092000 M3 

*W0.1 10(*,A6) 

*W0 

W0.1 10(*,A6)=920B2 

*W3.0 

*TD 

PC=00A2 A6=092000 



Define a window: 

Enter a value for the address register indirect 

Print the effective address of a window 

Set memory through the window 

Command to print memory through the window 

Display a line of memory 

00 00 00 00 00 00 00 00 00 00 00 . .SB 

Clear all registers from the trace display 
Define some registers for the display 
Command to print the trace display 
'42 NOTE:W3.4 and M3.1 only lowest byte displayed 
Change width of window 
Change width of display 



=0008 



Define a new window :PC+A6+10 

Print effective address of window W0 



Close window W3, undefine it 

Closed/undefined windows are not in the display 



"<■> and Breakpoints 
COMMAND FORMAT DESCRIPTION 



GO, BREAKPOINT 



Go 

Go address 

Go TILL address 

BR 

BR address 

BR -address 

BR address:count 

BR CLEAR 



Begin execution at address in PC register 

Begin execution at this address 

Set a temporary breakpoint at the address and run 

until a breakpoint is encountered 

Print the address of all breakpoints (8 maximum) 

Set a breakpoint at this address 

Remove the breakpoint at this address 

Set a breakpoint at this address with a count 

Remove all breakpoints 



EXAMPLES COMMENTS 

(see example program in section 1.7) 



*PC E00 

*TD CLEAR 

*TD PC. 2 D0.1 

*TD 

PC=OE00 D0=00 

*G TILL E08 

PC=0E08 D0=04 

*BR OE02 

*G 

PC=OE02 D0=01 

*BR E08:4 

*BR 

BRKPTS= 0E02 OE08:4 

*G 

PC=0E00 D0=4 

PC=0E02 D0=1 

*BR 

BRKPTS= 0E02 0E08:: 

*BR -E02 

*G 

PC=0E08 D0=4 

PC=0E08 D0=4 

PC=0E08 D0=4 

*BR 

*BRKPTS= 0E08 

*BR E08:2 

*G 

PC=0E08 D0=4 

PC=0E08 D0=4 

*BR E00 

*G E00 

PC=0E08 D0=4 

*SY JUMPER EOA 

*BR JUMPER: 5 

*BR 123456:7897 11 

TABLE FULL BRKPTS= 



Set program counter to starting address 

Set trace display format 
Print trace display 

Run until address 

System displays when it stops 

Set a breakpoint 

Run until breakpoint 

Trace display 

Set a breakpoint with a count 

Print the breakpoints 

Run 

Decrements count, prints display, continues 

Stops at breakpoint with zero count 

Print the breakpoints 

Count has been decremented by one 

Remove a breakpoint 

Run 

Count from 3 to 2... 

...2 to 1... 

...1 to and it stops here 
Print the breakpoints 

No count for this breakpoint, does not reset 
back to count value 
Reseting count 

Count 2 to 1 

Count 1 to and stop 

Set another breakpoint 

Start running from EOO, bypass breakpoint at 
starting address and stop at next breakpoint 

Define a symbol 

Set a breakpoint at a symbolic address 
22 33 44 55 66 Try to overflow table (holds 8) 
E08 EOO E0A:5 123456: 7897 11 22 33 44 



1.6.7 Set the Trace Display Format (Individual Registers) 
COMMAND FORMAT DESCRIPTION 



TRACE DISPLAY 



TD 

TD Clear 

TD ALT 

TD req#. format 



Print the trace display 

Take everything out of the display 

Put all registers in display (see section 3.6.8) 

Add or delete registers in display where reg* is 

D0-D7,A0-A7.W0-W7.M0-M7,PC.SR.ns.ss.A,D, or L (see 

the next section). 

Format can be 0,1,2,3,4 .Z f D,R. or S. 

0>«remove the item from the display 
l,2.l.4=print this number of bytes as hex 

characters, include all leading zeros 
Zosigned long word hex with zero suppress 
Designed long word decimal with zero suppress 
R=subtract offset (see OFfset command) then print 

-with Z format with letter 'R* at end 
S=search symbol table for 4 byte value, if found 

print symbol name as 8 characters, if not found 

print hex value as 8 characters 



EXAMPLES 



*PC 

*D1 5 

*A6 8F 

*TD CLEAR 

*TD PC. 3 Dl.l 

*TD 

PC=000000 Dl=05 

*TD PC.O A6 

*TD 

Dl=05 A6=0000008F 

*W3.2 92000 

*M3 20 

*TD M3.2 

*TD 

Dl=05 A6=0000008F M3=0020 

*TD A6.1 D1.3 M3.Z 

*TD 

Dl=000005 A6=»8F M3=20 

*TD Dl.R M3.D 

♦OFFSET 123 45 

*TD 

D1=-12340R A6=8F M3-32 

*SY TABLE 8F 

*TD A6.S M3.0 

*TD 

D1=-12340R A6=TABLE 

*A6 123 

*TD 

D1—12340R A6=00000123 



COMMENTS 

Initialize registers for example below 

Initialize registers for example below 

Initialize registers for example below 

Turn off all the registers in display 

Define PC as 3 bytes and Dl as one 

Command to display 

This is the trace display 

Remove PC and add A6 which defaults to 4 bytes 

Display 

Display with two new registers 

Define a window 

Set value of memory pseudo register 

Add a memory pseudo register to the display 

Display 

New display 

Change length of registers already in display 

Display 

New display, M3 now suppresses leading zeroes 

Dl is relative and M3 is decimal 

Set the offset (see OFfset command) 

Display 

5-offset=-12340r; 20 hex = 32 decimal 

Define a symbol (see SYmbol command) 

Make A6 print symbol if value is in table 

Prints symbolic value 

Set A6 to a value NOT inm symbol table 

A6 prints value with 4 byte format 



1.6.8 Set the Trace Display Format (Blocks of Registers) TRACE DISPLAY 

COMMAND FORMAT DESCRIPTION 

TD CLear Take everything out of the display 

TD D.l Put all data registers in display as a block 

TD A.l Put all address registers in display as block 

(for D.l and A.l the format is fixed at 4 
bytes) 
TD L. character Define a line separator at the end of display 

(.0 will reverse A.l, D.l, and L. char commands) 
TD AL1 Same as keying: 

*TD PC. 3 SR.2 US. 4 SS. 4 D.l A.l L.- 

does not affect other registers and windows 

that have been previously defined to 

display 

EXAMPLES COMMKNTR 

*td CLEAR Clear the display 

*TD D.l Define all data registers in a block 

*TD - Print the trace display 

D0=00000000 D1=00000000 D2=00000000 D3=00000000 

D4=00000000 D5=00000000 D6=00000000 D7=00000000 

*TD CLEAR 

*TD A.l Define all address registers in a block 

*TD 

A0-00000000 A1=00000000 A2=00000000 A3=00000000 

A4=00000000 A5=»00000000 A6=00000000 A7=00000FFC 

*TD L.0 Define a line separator (a row of ' @M 

*TD 

A0=»00000000 A1=00000000 A2-00000000 A3=00000000 

A4=00000000 A5=»00nnnn00 A6-00000000 A7=000nnppr' 

aQ0^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@8@@@@@@@@@@@@@8@@§@@@@@@@@@@@@§@§@@@@ 

*TD L.& Define a line separtator (a row of '&') 

*TD 

A0-00000000 A1=00000000 A2=00000000 A3=»00000000 

A4=00000000 A5=00000000 A6=00000000 A7=0000nFFC 

&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& 

*TD ALL Turn on commonly used registers... 

*TD ... thi3 is also the default or reset condi i. ; on 

PC=000000 SR=»2000 OS=00007F00 SS=00007FFE 

D0=00000000 D1=00000000 D2=00000000 D3=00000000 

D4=00000000 D5=00000000 D6=00000000 D7-00000000 

A0=00000000 Al-00000000 A2=00000000 A3=00000000 

A4=00000000 A5=00000000 A6=00000000 A7=0000OFFC 



1.6.9 Tracing 

COMMAND FORMAT 

Trace 

Trace count 

Trace TILL address 

:*(CR) 



DESCRIPTION 

Execute one instruction and print trace display 

Trace specified number of instructions 

Trace to the given address 

(breakpoint will stop the trace) 

A colon (:) before the prompt indicates a 

special trace mode is in effect/ a carriage 

return will trace the next instruction 



EXAMPLES COMMENTS 

(see example program in section 1.7) 

*TD CLEAR Remove all of trace display 

*TD PC. 2 DO.l Display only PC and DO 

*DM E00 Example program in memory 

000E00 70 01 70 02 70 03 70 04 70 05 4E P8 0E 00 FF FF 



*PC E00 

*TD 

PC=OEO0 D0=00 

*T 

PC=0EO2 D0=01 

:*(CR) 

PC=0E04 D0=02 

:*T3 

PC=0E06 D0=03 

PC=0E08 D0=04 

PC=0E0A D0=05 

♦T-TILL E04 

PC=0E00 D0=05 

PC=0E02 D0=01 

PC=0E04 D0=02 



Set the program counter 
Print the trace display 



Trace one instruction 



Special prompt appears, carriage return will 
trace the next instruction 
Trace three instructions 



Trace till instruction at address E04 



1.6.10 Offset 



OFFSET 



The 68000 instruction set lends itself to relocatability and position 
independence. A general purpose, global offset feature has been provided. 
The single offset address applies to all of the commands listed below. 
Registers displayed in the trace display may have the offset subtracted by 
using R as the format. See paragrpah 1.6.7 on trace display. 

The offset may be overriden by entering a comma and alternate offset. All 
commands do not use the offset but any number can be forced to be relative 
(have the offset added) by entering an R as the last character of the 
number . 



WARNING: This is a very simple offset feature and may not be able to solve 
complex relocation problems. The user is encouraged to experiment with the 
global offset and the window features to determine their limitations and 
usefulness in a particular application. 



COMMAND FORMAT 



DESCRIPTION 



OFfset 

OFfset hex value 

OFfset 

command data, alternate 
command data, 
command data, OR 



Display offset 

Set the offset to a given value 

Set the offset to zero - begin absolute 

addressing 
Disregard offset, add alternate offset to data 
Data is absolute, no offset added 
Dsed in commands that do not normally use 

offset, adds offset to data 



The offset affects the following commands: 

TD reg.R Trace display, substract offset from register value 

BReakpoint Set breakpoint (display is in absolute) 

Go All addresses 

SM All addresses 

DM All addresses (display is in absolute) 

REad All addresses 



EXAMPLE 



COMMENTS 



*PC 2010 

*TD PC.R 

*TD 

PC=2010R 

*OF 2000 

*TD 

PC=10R 

*BR 6 

*BR 

BRKPTS=2006 

*BR 24,3000 

*BR 

BRKPTS=2006 3024 



Set the program counter 

Set trace display. R means nex long word minus offset 

Display 

Displayed relative to offset (zero now) 

Set the offset ot 2000 

Display 

PC - offset = 2010-20 00 = 10 Relative 

Set a breakpoint: hex data+offset = 6+20 00 = 2006 

Display breakpoint 

Breakpoints are always displayed as absolute hex 

Set a breakpoint with alternate offset 24+3000 



i .6.11 Number Base Conversion 



NUMBER CONVERSION 



COMMAND FORMAT DESCRIPTION 

CV decimal or & decimal Decimal to hex conversion 

CV $hex Hex to decimal conversion 

CV symbol Use value from symbol table 

CV value, offset Calculate offset or displacement 

NOTE 



This command DOES NOT automatically use the global 
offset. The default base for this command only is 
decimal. All numbers are signed 32 bit values. 



EXAMPLES 



*CV 128 

$80=&128 

*CV $20 

$20=532 

*CV -$81 

$FFFFFF7F=-$81=-S129 

*CV $444,111 

$555=S1365 

*CV $444.-111 

$333=5819 

*SY TEN 510 

*SY THIRTY 530 

*CV TEN 

$A=&10 

*CV -TEN 

$FFFFFFF6=-$A=-S10 

*CV THIRTY, -TEN 

$14=&20 

*OF 2000 

*CV $123R 

$2123=58483 
*CV TEN, OR 
$200A=S8202 



COMMENTS 

Command to convert decimal to hex 
Computer response 
Hex to decimal 

Negative numbers 

Adding an offset (second number's base 

defaults to first number's) 

Subtracting an offset (forward displacement) 

Defining a symbolic decimal constant 

Command can be used with symbols 



Define a global offset 

R at the end 

of a number means add the 

global offset 

Symbolic relative 



1.6.12 Download and Verify DOWNLC 

COMMAND FORMAT DESCRIPTION 

REad;-CX =text Load S records - default PORT 2 

option -C means ignore checksum; 

option X means display data being read; 

if equal sign is used in this command line then 

everything after it is sent to PORT 2 

VErify;=text Verify memory with S records - print difference; 

verify does not use checksum 



EXAMPLE 



NOTE 

These commands use the offset. No attempt is made to 
control the host transmissions. For the REad and VErify. 
any line received not beginning with the letter S is ignored 
(see appendix A for S record formats). If an error occurs 
causing the system to take the time to print out an error 
message, one or more lines sent during the error message may 
have been ignored. 

COMMENTS 



*READ;=COPY FILE.MX,#CN 

*DM E00 10 

OOOEOO 70 01 70 02 70 03 70 

♦VERIFY ;=COPY FILE.MX,#CN 

*SM E05 FF 

*DM E00 

OOOEOO 70 01 70 02 70 FF 70 

♦VERIFY ;=COPY FILR.MX.#CN 

S1110E0O 03 

*RE;--COPY FILE2.MX,#CN 

S1110E007001700270/370047005 

*RE;=COPY FILE2.MX, #CN 

S1110E0070017002700370047005 

*RE;=COPY FILE.MX, #CN 

*OF 5423 

*RE;=COPY FILE.MX, #CN 

*DM 1000 

006423 70 01 70 02 70 03 70 



Download from an EXORciser. 
Check to see if data was loaded 

04 70 05 4E F8 0E 00 FF FF 

Normal verify returns with prompt 
Deliberately change memory to show verify 
Verify that 03 was changed to FF 

04 70 05 4E F8 0E 00 FF FF 

Displays only nonmatching data bytes 

Example of file with bad character 
4EF80E0049 NOT HEX=/ 

Example of file with bad checksum 
4EF80E003 9 CHKSUMM9 

Normal read returns with prompt 

Download with offset 

Display memory, adds offset to parameters 
04 70 05 4E F8 0E 00 FF FF 



1.6.13 The CALL Command 



The call command can be used to add commands. 
a subroutine which ends with an RTS. 



This is done by writing 



The call command does not affect the user's registers and is not to be 
confused with the GO command. The user may use a symbol as the 
command parameter instead of an absolute starting address. Registers 
A5 and A6 point to the start and end of the I/O BUFFER (see RAM 
equate file listing, paragraph 1.11) so the user may pass additional 
parameters on the comand line. 



COMMAND FORMAT 
CALL address 

EXAMPLE 

♦CALL 3000 23 45 ZZ 



*SY FIXUP 2300 
*CALL FIXUP 



DESCRIPTION 

JSR to user subroutine, routine must 
end with RTS 

COMMENTS 

JSR to user routine at location 3000 
note that 23 45 & ZZ may be additional 
parameters that the user's subroutine 
will decode and are ignored by MACSbug 
Define a symbol as absolute address 2300 
JSR to symbolic address 



1.6.14 Transparent Mode 
COMMAND FORMAT 
P2 [char] 



and Host Communication 



DESCRIPTION 



TRANSPARENT 



(control A) 



♦...data... 



MACSBDG 2.0 

*P2 

♦TRANSPARENT* EXIT=$01 



(CONTROL A) 
*MACSBDG* 



**E800; G 

*P2 & 

♦TRANSPARENT*" EXIT=$26 

}S 

♦MACSBOG* 



Enter transparent mode: The optional user 
defined exit character [char], defaults to 
control A ($01). This command logically 
connects port 2 (host) and port 1 (console) . 
Host transmissions go directly to the console 
and console transmissions go directly to the 
host. The BAUD rates on the two ports may be 
the same or port 2 may be less. 

Default character to end the 
transparent mode, alternate character 
may be defined in P2 command 

Asterisk.*, as the first character of 
the console input buffer means transmit 
the rest of the buffer to the host 
(PORT 2), the BAUD rates of the two 
ports (1 and 2) do not have to be the same. 

COMMENTS 

Start up or reset condition 
Command to enter transparent mode 
MACSbug prints this, the EXIT=$01 
means to exit this mode, enter control A 

User talks direct to the host, uses the 
editor, assembler, etc. 

Ends the transparent mode 

MACSbug prints this and system is ready 
for new command 

System prompts with * and user enters 
' *MAID" 

Everything after the second * is sent 

to the host 

(NOTE: the BAUD rates do not have to be the same) 

Enter transparent mode, '&' is the exit 
character 

Displays exit character (&) as hex value 26 

User exits transparent mode by entering '&' 

Command mode prompt 



1.7 EXAMPLE OF COMMAND PROCEDURES 



MACSBDG 2.0 
*P2 



♦TRANSPARENT* EXIT=$01 



Start up condition 

MACSbug prompts with * user enters P2 to 

enter transparent mode. 

Message printed to indicate user is now 

directly connected with host system 



- NOTE: The following example is using a MOTOROLA EXORciser host system - 



MAID 
**E800;G 
MDOS3.0 
=MACS FILE;CO 



FILE 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 



MC68000 ASM REV= l.OC 



Boot up MDOS 



Assemble a source file (see M68000 Cross 
Macro Assembler manual) 
- COPYRIGHT BY MOTOROLA 1978 



000E00 
00OEO2 
000E04 
000EO6 
000E08 
000E0A 



00000E00 

7001 

7002 

7003 

7004 

7005 

4EF80E00 



EXAMPLE PROGRAM FOR 68000 MACSBDG 
TO DEMONSTRATE TRACING, BREAKPOINTS, 
ORG $0E00 



AND GO 



MOVE.L #1,D0 

MOVE.L #2, DO 

MOVE.L #3, DO 

MOVE.L #4, DO 

MOVE.L #5, DO 
JMP START 
END 



LOADED INTO REG DO 



DO IT AGAIN 



******TOTAL ERRORS 0-0 



SYMBOL TABLE 

JUMPER 000E0A START 



000E00 



=COPY FILE. MX, #CN 

S00600004844521B 

S1110E007001700270037 

S9030000FC 

= (control A) 

♦MACSBDG* 

♦READ ;=COPY FILE. MX, 

♦DM E00 

000E00 70 01 70 02 70 

♦PC E00 

♦TD CLEAR 

♦TD PC.2D0.1 

♦TD 

PC=0E0O D0-00 

*BR E04 

*T TILL 

PC=0E02 D0=01 

PC=0E04 D0=02 

*GO 

PC=0E04 D0=02 



MDOS command to list file on console 
Header record 
00470054EF80E0049 Data record 
End-of-file 
Ends transparent mode 

Message put out by MACSbug to indicate user is 
now in MACSbug command mode 
♦C Download from EXORciser host 
Display memory 
03 70 04 70 05 4E F8 0E 00 FF FF 

Set program counter to START 

Clear the trace display 

Specify which registers to print in display 

Print the trace display 



(see sec. 1.6.12) 
(see sec. 1.6.2) 



(see sec. 1.6.1) 
(see sec. 1.6.7) 



Set a breakpoint 
Trace command 

Stopped at breakpoint 

Stopped at breakpoint 
Program is ready to run 



(see sec. 1.6.6) 
(see sec. 1.6.9) 



(see sec. 1.6.6) 



1.8 I/O SPECIFICATIONS 

Provisions have been made for the user to substitute his own I/O routines 
and direct the I/O for some commands to these routines. There are three 
pairs of locations in RAM that hold the addresses of the I/O routines. 
(See paragraph 1.11 on the equate file of RAM locations used by MACSbug. ) 
They are initialized when the system is booted to contain the addresses of 
the default routines in MACSbug ROMs. 

INPORT1 and OUTPORT1 are defaulted to port 1 which is MACSbug' s console. 
The MACSbug prompt, command entryr all error messages, and all other 
unassigned I/O use these addresses to find the I/O routines. Most 
commands do not need a port specifier to use PORT 1. The REad and VErify 
commands, however, default to PORT 2. 

INPORT2 and 0DTP0RT2 are defaulted to port 2 which is the host system (an 
EXORciser or timesharing system, etc.). Output or input is directed to 
this port by including a port specifier in the command field of the 
command line. 

For example: *RE2;-C 

The 2 in the command RE2 specifies that the addresses for the I/O routines 
will be found in the RAM locations INPUT2 and 0DTPUT2. Error messages, 
however, will be printed on PORT 1 - MACSbug's console. 

INPORT3 and 00TP0RT3 are inititalized to the same routine addresses as PORT 
1 when the system is booted. The user can insert the addresses of his own 
I/O routines into these locations. I/O can then be directed to his 
configuration by using a 3 in the command field. 

EXAMPLES COMMENTS 

*READ3;-C Memory load from port 3; checksum ignored 

*VERIFY1 Verify memory with 'S' records coming in from PORT 1 

*DM2 50 80 Display memory sending output to PORT 2 

The BADD rates of the two RS-232C serial ports can be changed by setting 
memory locations $06BA and $06BC. 



ADDRESS 


PORT 


VALUE 


506BA 


1 


IX 


506BC 


2 


IX 



The Hex digit X can be set to select various BAUD rates as shown below: 

X = 6 7 8ACE F 

BAUD RATE - 300 600 1200 2400 4800 9600 19200 

EXAMPLES COMMENTS 

SM 6BA 16 Set BADD rate to 300 for port 1 

SM 6BC IF Set BAUD rate to 19200 for port 2 



1.9 DSER I/O THROUGH TRAP 15 
Format in user program: 



TRAP #15 Call to MACSbug trap handler 

DATA.W function Valid functions listed below. 

Program resumes with next instruction. 



DESTINATION 



P0RT1 console 
P0RT1 console 
P0RT2 host 
P0RT2 host 



FUNCTION 

Coded Breakpoint 
Input line 
Output line 
Read line 
Print line 



BUFFER 



A5=A6 is start of buffer. 
A5 to A6-1 is buffer. 
A5=A6 is start of buffer. 
A5 to A6-1 is buffer. 



EXAMPLE PROGRAM: 



0000 
0004 



0006 
0008 



4BFA 
2C4D 



4E4F 
0001 



001A+ 



000A 4E4F 



1* 

2* 

3* 

4* 

5* 

6* 

7* 

8* 

9* 

10* 

11* 

12* 

13* 

14* 

15* 

16* 

17* 

18* 

19* 

20* 

21* 

22* 

23* 

24* 

25* 

26* 

27* 



START 



file : MBUG.EX.TEXT 

Example of using TRAP #15 facility in 
MacsBug. This program is assembled with 
ASM68K then linked using the Concept 
LINKER. It was executed by calling out 
the code file. 



COMMAND LINE: 
asm68k mbug.ex 
linker mbug.ex 
mbug.ex 



LEA BUFFER, 

MOVEA.L A5, A6 



A5 



COMMENT: 
assemble file 
link 
execute 



jlnit buffer 
.•pointers 



Input buffer from Port 1 



TRAP 
DATA.W 



#15 
1 



;echoes input 



Output buffer to Port 2 
TRAP #15 



OOOC 0004 



OOOE 4E4F 
0010 0000 



0012 7021 

0014 B03A 0006+ 

0018 66E6 

001A 4E75 



001C 
0054 



00000000 
00000000 



008C 00000000 
00000000+ 



28* 
29* 
30* 
31* 
32* 
33* 
34* 
35* 
36* 
37* 
38* 
39* 
40* 
41* 
42* 
43* 
44* 
45* 
46* 
47* 
48* 
49* 



DATA.W 4 

Enter HacsBug - a coded breakpoint 

TRAP #15 

DATA.W 

if first char in buffer = "1" then exit 

MOVEQ #M'.D0 

CMP.B BUFFER, DO ;lst char = "!" 

BNE.S START ;no, do again 

RTS 



DATA.L 0,0,0,0,0,0,0,0,0,0,0,0,0,0 

DATA.L 0,0,0,0,0,0,0,0,0,0,0,0,0,0 

DATA.L 0,0,0,0,0,0,0,0,0,0,0,0,0,0 

END START 



00001C+ START 



000000+ 



1.10 GENERAL INFORMATION 

TRAP ERROR is the general message given when an unexpected trap occurs. 
Nearly all of the low vectors including the user traps, interrupts, divide 
by zero, etc. are initialized during booting to point to this simple error 
routine. No attempt is made to decipher which trap happened, but the user's 
registers are saved. The system usually retrieves the right program counter 
from the supervisor stack but some exception traps push additional informa- 
tion on to the stack and the system will get the program counter from the 
wrong place. It is recommended that the user's program reinitialize all 
unused vectors to his own error handler. 

The REad command may have problems in some configurations. No attempt is 
made to control the equipment sending the information. When the system 
recognizes the end of a line it must process the buffer fast enough to be 
able to capture the first character of the next line. Normally the system 
can download from an EXORciser at 9600 baud. If the system is having 
problems, it might be worthwhile to experiment with lower BAUD rates. 

The REad routine DOES NOT protect any memory locations. The routine will 
not protect itself from programs trying to overlay the I/O buffer. This 
will, of course, lead to errors during the download. Any location in memory 
can be loaded into, including MACSbug's RAM area. This allows the user to 
initalize such locations as the starting and ending address of the symbol 
table. All the registers may be initialized except the program counter 
which takes its address from the S8 or S9 record. 

The REad command, supports the normal SO, Si, S2, S8 . and S9 record format,", 
(See Appendix for a description of these S Records.) 

TRAP 15 is used by both the user I/O feature and breakpoints. When the 
program is running, the address of the breakpoint routine is normally in 
the TRAP 15 vector. When program execution is stopped, the I/O routine 
address is normally inserted into TRAP 15 vector. If I/O is not needed 
in the program, the user may change the vector with the SM command. If 
breakpoints are not needed, the program may change the vector while the 
program is running. It is recommended, however, that the user should use 
the other 15 vectors (or other programming techniques) and let MACSbug 
control TRAP 15. 



1.11 EQUATE FILE OP RAM USED BY 68000 MACSbug 2.0 



* WARNING TO USER: The addresses listed below and their usage as described 
in this document are intended for only this version (2.0) of MACSbug. 
Corvus does not guarantee the usage of these locations. 



USERS PROGRAM COUNTER 

USERS CONDITION CODES 

4BYTES*3SECTIONS*8REG(OR MEM) 

WHERE A7 REG IS 

USER STACK 

ASSUMED OFFSET 

TRACE DISPLAY FORMATS 

SPECIAL FORMAT FLAGS 

WINDOW PARAMETERS 

LOW RANGE FOR LOOP FEATURE 

HIGH RANGE FOR LOOP FEATURE 

BREAKPOINT ADDRESSES 

TEMPORARY BREAKPOINT 

BREAKPOINT COUNTS 

HOLD USER WORDS REPLACED BY TRAP IN SET 

HOLDS USER'S TRAP 15 VECTOR 

CHARACTER NULL PADS 

CARRIAGE RETURN NULL PADS 

STOP BITS (ACIA PROGRAM) 

HOLDS ADDRESS OF OUTPUT ROUTINE 

HOLDS ADDRESS OF INPUT ROUTINE 

ALTERNATE ACIA PORT#l 

ALTERNATE ACIA PORT*2 

INPUT ROUTINE ADDRESS 

ADDRESS FOR OUTPUT ROUTINE 

ADDRESS FOR INPUT ROUTINE 

FOR OUTPUT ROUTINE 

PORT #3 INPUT ROUTINE 

PORT #3 OUTPUT ROUTINE 

TRACE COUNTER 

FLAG FOR TRACE ON 

1=SAVE USER REGISTERS ;0=NOT 

1=BP ARE IN; 0=ARE OUT OF MEMORY 

PRINT THIS BEFORE TRACE DISPLAY 

PRINT THIS AFTER 

WORK VARIABLE 

WORK VARIABLE 

WORK VARIALBE 

WORK SPACE 

WORK SPACE 

WORK SPACE 

START OF SYMBOL TABLH 

END OF SYMBOL TABLE 

START OF COMMAND TAB 

WORKING STORAGE BUFF 

ROOM FOR STACK 

START OF STACK (GOES DOWN) 







ORG $400 


400 


REG PC 


DS.L 


1 


404 


REGSR 


DS.L 


1 


408 


REGS 


DS.B 


4*2*8 


444 


REGA7 


EQU I 


*EGS+6l 


448 


REG US 


DS.B 


4 


44C 


OFFSET 


DS.L 


1 


450 


FORMAT 


DS.B 


36 


474 


ADALL 


DS.L 


1 


478 


WINDOWS 


DS.B8*8 


4B8 


LOOPRl 


DS.L 


1 


4BC 


LOOPR2 


DS.L 


1 


4C0 


BPADD 


DS.L 


8 


4EO 


BPTILL 


DS.L 


1 


4E4 


BPCNT 


DS.L 


9 


508 


BPDATA 


DS.W 


9 


51A 


SAVETRAP 


DS.L 


1 


51E 


NULLPADS 


DS.B 


2 


520 


CRPADS 


DS.B 


2 


522 


SB IT 


DS.B 


2 


524 


OUTTO 


DS.B 


4 


528 


INFROM 


DS.B 


4 


52C 


ALTACIA1 


DS.L 


1 


530 


ALTACIA2 


DS.L 


1 


534 


INPORT1 


DS.L 


1 


538 


OUTPORT1 


DS.L 


1 


53C 


INPORT2 


DS.L 


1 


540 


OUTPORT2 


DS.L 


1 


544 


INPORT3 


DS.L 


1 


548 


OUTPORT3 


DS.L 


1 


54C 


TRACECNT 


DS.L 


1 


550 


TRACEON 


DS.W 


1 


552 


RUN 


DS.W 


1 


554 


BPSTATUS 


DS.W 


1 


556 


SCREENl 


DS.L 


1 


55A 


SCREEN2 


DS.L 


1 


55E 


BASE 


DS.B 


2 


560 


SIGN 


DS.B 


2 


562 


VECTOR 


DS.B 


2 


564 


TEMP 


DS.B 


4 


568 


WORK1 


DS.L 


1 


56C 


WORK2 


DS.L 


1 


570 


STRSYM 


DS.L 


1 


574 


ENDSYM 


DS.L 


1 


578 


CMDTABLE 


DS.L 


1 


57C 


BUFFER 


DS.B 


$128 


6A4 




DS.B 


20 


6B8 


SYS TACK 


DS.B 


2 



Appendix A 

S RECORDS 

An S record is a standard Motorola record format used in downloading 
programs and data with MACSbug. 

There are ten possible standard S record types, five of which can be used 
with MACSbug. They are as follows: 

50 Header record 

51 16 bit address Data record 

52 24 bit address Data record 

58 24 bit address End of File/Execution Address record 

59 16 bit address End of File/Execution Address record 

The standard S record is defined as follows: 



RAME 


VALUE 




DESCRIPTION 


BYTE 
COUNTED 


CHECK 
SUMMED 


1 

2 

3,4 

5-8 

5-10 


$53 
$30- 


(S) 
$39 (0- 


-9) 


Start of Record 
Record Type 
Byte Count 
Address (for 16 bit) 
Address (for 24 bit) 

Data 


* 
* 
* 
* 
* 


* 
* 
* 
* 
* 
* 


N-1,N 








Checksum 


* 





The letter "S" and the Record Type are represented directly in ASCII. 

The byte count, address, data, and checksum are represented in ASCII 
encoded hexadecimal; i.e., two frames per data byte, with the most 
significant digit in the leading frame. 

The checksum is the l's complement of the sum of all 8-bit data/address 
bytes from byte count to last data byte, inclusive. 

TYPICAL OBJECT S-RECORD FORMAT 

S00600004844521B 

S1131000307C1000327C1FFE123C00804280428300 

S1131010383C09964A016A0000121A18BOC96600E1 

S1131020000AD2FC00026000002EE3113400E352F7 

S11310300242000BE30D050466000006E25860D48A 

S1131040E2580840000F60CC4A016A00000A1A18EE 

S1131050B0C96700002AE3113400E3520242000BD6 

S113106005046600000CE35B08C300006000000890 

S1131070E35B08830OO0E25808C0000F60CA31C374 

S10710801FFE4E728B 

S00600004844521B 

S20A010000323C00035641ED 

S9030000FC 



First two characters 



- SO Starts of the first record. 

- SI Indicates that the object data that 

follows will be at a two-byte 
memory address. 

- S2 Same as SI, but indicates a three- 

byte memory address. 

- S8 Same as S9 , but indicates a three- 

byte memory address. 

- S9 Last Record 



Third and fourth characters 



- Hexadecimal byte count of the remaining 
characters in the record. 



Fifth through eighth characters - Hexadecimal memory address where the 

data that follows is to be loaded. If 
the record is "S2" or "S8" type, the 
fifth through tenth characters contain 
the memory address. 



Last two characters 



Checksum of all characters from byte 
count to the end of data. 



